home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat3 / Tk / internatom.z / internatom
Encoding:
Text File  |  1998-10-30  |  3.4 KB  |  67 lines
  1.  
  2.  
  3.  
  4. TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm((((3333TTTTkkkk))))                                          TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm((((3333TTTTkkkk))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      Tk_InternAtom, Tk_GetAtomName - manage cache of X atoms
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
  13.  
  14.      Atom
  15.      TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm((((_t_k_w_i_n, _n_a_m_e)
  16.  
  17.      char *
  18.      TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee((((_t_k_w_i_n, _a_t_o_m)
  19.  
  20. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  21.      Tk_Window   _t_k_w_i_n    (in)      Token for window.  Used to map atom or
  22.                                     name relative to a particular display.
  23.  
  24.      char        *_n_a_m_e    (in)      String name for which atom is desired.
  25.  
  26.      Atom        _a_t_o_m     (in)      Atom for which corresponding string name
  27.                                     is desired.
  28.  
  29.  
  30. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  31.      These procedures are similar to the Xlib procedures XXXXIIIInnnntttteeeerrrrnnnnAAAAttttoooommmm and
  32.      XXXXGGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee.  TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm returns the atom identifier associated with
  33.      string given by _n_a_m_e;  the atom identifier is only valid for the display
  34.      associated with _t_k_w_i_n.  TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee returns the string associated with
  35.      _a_t_o_m on _t_k_w_i_n's display.  The string returned by TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee is in
  36.      Tk's storage:  the caller need not free this space when finished with the
  37.      string, and the caller should not modify the contents of the returned
  38.      string.  If there is no atom _a_t_o_m on _t_k_w_i_n's display, then TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee
  39.      returns the string ``?bad atom?''.
  40.  
  41.      Tk caches the information returned by TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm and TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee so
  42.      that future calls for the same information can be serviced from the cache
  43.      without contacting the server.  Thus TTTTkkkk____IIIInnnntttteeeerrrrnnnnAAAAttttoooommmm and TTTTkkkk____GGGGeeeettttAAAAttttoooommmmNNNNaaaammmmeeee are
  44.      generally much faster than their Xlib counterparts, and they should be
  45.      used in place of the Xlib procedures.
  46.  
  47.  
  48. KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  49.      atom, cache, display
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.